home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_ghostscript.idb / usr / freeware / doc / ghostscript / 3.33 / use.doc.z / use.doc
Encoding:
Text File  |  1998-05-21  |  42.3 KB  |  1,087 lines

  1.    Copyright (C) 1989, 1995 Aladdin Enterprises.  All rights reserved.
  2.   
  3.   This file is part of GNU Ghostscript.
  4.   
  5.   GNU Ghostscript is distributed in the hope that it will be useful, but
  6.   WITHOUT ANY WARRANTY.  No author or distributor accepts responsibility to
  7.   anyone for the consequences of using it or for whether it serves any
  8.   particular purpose or works at all, unless he says so in writing.  Refer
  9.   to the GNU Ghostscript General Public License for full details.
  10.   
  11.  
  12. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  13.  
  14. This file, use.doc, describes how to use the Ghostscript language
  15. interpreter.
  16.  
  17. For an overview of Ghostscript and a list of the documentation files, see
  18. README.  
  19.  
  20. ********
  21. ******** How to install Ghostscript ********
  22. ********
  23.  
  24. To run Ghostscript, you need the executable program, and also some
  25. external initialization files:
  26.     gs_*.ps (see psfiles.doc for the full list), unless Ghostscript was
  27.       compiled using the "compiled initialization files" option
  28.     Fontmap
  29.  
  30. The file name of the executable program depends on the environment;
  31. see the instructions for the specific platforms below.
  32.  
  33. The Ghostscript fileset includes a set of fonts (.gsf files); you should
  34. have them on line as well, unless you have a complete set of other fonts
  35. (such as ATM or Display PostScript fonts) and are using a Fontmap and/or
  36. GS_FONTPATH that references them.
  37.  
  38. VMS
  39. ---
  40.  
  41. Installing Ghostscript on a VMS system requires compiling it first.  The
  42. name of the executable is GS.EXE.
  43.  
  44. You should install all the files, including the fonts, in the same
  45. directory as the executable and initialization files.  By default, this is
  46. the directory in which you did the compilation.  Consult the command file
  47. (VMS*.MAK) for more details.
  48.  
  49. If you have DECWindows/Motif installed, you may wish to replace the FONTMAP
  50. file with the file FONTMAP.VMS.  Read the comment at the beginning of the
  51. latter file for more information.
  52.  
  53. MS-DOS
  54. ------
  55.  
  56. There are two MS-DOS executables in the standard Ghostscript
  57. distribution:
  58.     - GS.EXE runs on any MS-DOS machine, but is limited to 640K.
  59.     - GS386.EXE runs on any 386 or 486 machine, and will use all
  60. available extended (not expanded) memory.
  61.  
  62. You should install all the files except the fonts in C:\GS, and the
  63. fonts in C:\GS\FONTS.
  64.  
  65. If you have Adobe Type Manager fonts installed on your system, and you wish
  66. to use them with Ghostscript, you may wish to replace the FONTMAP file with
  67. FONTMAP.ATM, and to add to the environment variable GS_LIB the name of the
  68. directory where the fonts are located (see below for more information about
  69. GS_LIB).  Before you do this, please read carefully the license that
  70. accompanies the ATM fonts; Aladdin Enterprises takes no responsibility for
  71. any possible violations of such licenses.  Similarly, if you have Adobe
  72. Type Basics, you may wish to replace FONTMAP with FONTMAP.ATB.
  73.  
  74. MS Windows
  75. ----------
  76.  
  77. The name of the executable is GSWIN.EXE.  Ghostscript probably requires
  78. Windows 3.1, and you must run Windows in 386 Enhanced or Standard (not
  79. Real) mode.  Since Ghostscript is a large program, you will need to run
  80. Windows in Enhanced mode (so that it can provide virtual memory) unless
  81. you have at least 6 Mb of RAM.
  82.  
  83. You should install all the files except the fonts in C:\GS, and the fonts
  84. in C:\GS\FONTS.
  85.  
  86. See under "MS-DOS" above for information about using Adobe Type Manager
  87. fonts with Ghostscript.
  88.  
  89. The files COMMDLG.DLL and SHELL.DLL supplied with Ghostscript are only for
  90. use with Windows 3.0.  If you have Windows 3.1, delete these files, since
  91. Windows itself provides versions of them.
  92.  
  93. If your system uses TrueType fonts, you can get them converted to a
  94. Ghostscript-compatible format at the time you select your "printer" by
  95. doing the following:
  96.  
  97. 1)    Open control panel and double click on the printers icon.
  98. 2)    Select your Postscript Printer.
  99. 3)    Choose Setup.
  100. 4)    Choose Options.
  101. 5)    Choose Advanced.
  102. 6)    At the top of the Dialog Box you will see TrueType Fonts
  103.     Send to Printer As: <drop down menu>
  104.     Choose Adobe Type 1.
  105. 7)    Uncheck Use Printer Fonts for All TrueType Fonts
  106.     and Use Substitution Table.
  107. 8)    OK.
  108. 9)    OK etc.
  109.  
  110. That's it!  Your TrueType fonts will automatically be downloaded in your
  111. PostScript file for Ghostscript to use.
  112.  
  113. OS/2 2.x
  114. --------
  115.  
  116. The Ghostscript OS/2 implementation is designed for OS/2 2.1.  A few people
  117. have used it successfully under OS/2 2.0, but it has had very little
  118. testing.
  119.  
  120. The name of the executable is GSOS2.EXE.  This is a text application that
  121. will run windowed or full screen.  The default device is "os2pm" which
  122. displays output in a Presentation Manager window using the external driver
  123. GSPMDRV.EXE.  GSPMDRV.EXE must be located in the same directory as
  124. GSOS2.EXE or on the PATH.
  125.  
  126. GSOS2.EXE and GSPMDRV.EXE are compiled using EMX/GCC 0.8h.  You must have
  127. the EMX DLL's on your LIBPATH.  These are available from
  128. ftp.cdrom.com:pub/os2/2_x/unix/gnu/emx08h/emxrt.zip.
  129.  
  130. The system menu of the Ghostscript Image window includes a "Copy" command
  131. to copy the currently displayed bitmap to the Clipboard.
  132.  
  133. OS/2 comes with some Adobe Type Manager fonts. If you wish to use these
  134. with Ghostscript, you should replace the FONTMAP file with FONTMAP.OS2,
  135. and add to the environment variable GS_LIB the name of the directory where
  136. the fonts are located, usually c:\psfonts.  (see below for more
  137. information about GS_LIB).  Before you do this, please read carefully the
  138. license that accompanies the ATM fonts; Aladdin Enterprises takes no
  139. responsibility for any possible violations of such licenses.
  140.  
  141. Since GSOS2.EXE is not a PM application, it cannot determine the depth of
  142. the PM display.  You must provide this information using the
  143. -dBitsPerPixel option.  The default is 8 bits/pixel.  Valid values are 1,
  144. 4, 8, 16 & 24.
  145.   For monochrome VGA use      -dBitsPerPixel=1
  146.   For standard VGA screen use -dBitsPerPixel=4
  147.   For 256 colour SVGA use     -dBitsPerPixel=8
  148. A command file gspm.cmd containing the following line may be useful:
  149.   @c:\gs\gsos2.exe -Ic:/gs;c:/gs/fonts;c:/psfonts -sDEVICE=os2pm 
  150.       -dBitsPerPixel=8 -sPAPERSIZE=a4 %1 %2 %3 %4 %5 %6 %7 %8
  151.  
  152. While drawing, the os2pm driver updates the display every 5 seconds.  On
  153. slow computers this is undesirable and a different interval can be
  154. specified in milliseconds with the -dUpdateInterval option.  The default
  155. is -dUpdateInterval=5000; to disable update use -dUpdateInterval=0.
  156.  
  157. Standard VGA is very slow due to double buffering to avoid bugs and due to
  158. 1 plane to 4 plane conversion.  Use a 256 color display driver by
  159. preference.  Many display drivers have bugs which cause 1 bit/pixel
  160. bitmaps to be displayed incorrectly.
  161.  
  162. GSOS2.EXE and GSPMDRV.EXE will stay in memory for the number of minutes
  163. specified in the environment variable GS_LOAD.
  164.  
  165. Ghostscript can also be run in a DOS box.  Please read the MS-DOS notes, 
  166. since they apply to this environment as well.
  167.  
  168. If you run GS386 in the OS/2 2.0 or 2.1 DOS Box, you must select the
  169. "ENABLED" setting for the DPMI_DOS_API option of the DOS Box.  GS386
  170. will not run with the "AUTO" setting.
  171.  
  172. Unix
  173. ----
  174.  
  175. Installing Ghostscript on a Unix system requires compiling it first.
  176. The name of the executable is gs.  The makefile installs all the
  177. files, except the fonts, in /usr/local or various subdirectories
  178. thereof.  The fonts should be installed in
  179. /usr/local/lib/ghostscript/fonts.  Consult the makefile for more
  180. details.
  181.  
  182. ********
  183. ******** Shell scripts for Ghostscript
  184. ********
  185.  
  186. The Ghostscript distribution includes several Unix shell scripts for
  187. driving Ghostscript in different environments.  These are all
  188. user-contributed code: please contact the user identified in the file, not
  189. Aladdin Enterprises, if you have questions.
  190.  
  191. > pv.sh - preview a specified page of a dvi file in an X window.
  192.  
  193. > sysvlp.sh - System V 3.2 lp interface for parallel printer.
  194.  
  195. > pj-gs.sh - printing on an H-P PaintJet under HP-UX.
  196.  
  197. > unix-lpr.sh - queue filter for lpr under Unix.
  198. > lprsetup.sh - setup for unix-lpr.sh.
  199.  
  200. If one of these serves your needs, you may be able to skip most of
  201. the rest of this document.
  202.  
  203. ********
  204. ******** How to use Ghostscript ********
  205. ********
  206.  
  207. To invoke the interpreter, give the command
  208.     gs <filename1> ... <filenameN>
  209. The interpreter will read in the files in sequence and execute them.
  210. After doing this, it reads further input from the primary input stream
  211. (normally the keyboard).  Each line (i.e. characters up to a <return>) is
  212. interpreted separately.  To exit from the interpreter, type quit<return>.
  213. The interpreter also exits gracefully if it encounters end-of-file.
  214. Typing the interrupt character, e.g., control-C, is also safe.
  215.  
  216. The interpreter recognizes several switches described below, which may appear
  217. anywhere in the command line and apply to all files thereafter.
  218.  
  219. You can get a brief help message by invoking Ghostscript with
  220.     gs -h
  221. or
  222.     gs -?
  223. This message also lists the available devices.  For a little more
  224. information about available devices, a one-line description of each device
  225. appears near the beginning of the file devs.mak.
  226.  
  227. Choosing the output device
  228. --------------------------
  229.  
  230. Ghostscript may be built with multiple output devices.  Ghostscript
  231. normally opens the first one and directs output to it.  To use device xyz
  232. as the initial output device, include the switch
  233.     -sDEVICE=xyz
  234. in the command line.  Note that this switch must precede the first .ps
  235. file, and only its first invocation has any effect.  For example, for
  236. printer output in a normal configuration that includes an Epson printer
  237. driver, you might use the shell command
  238.     gs -sDEVICE=epson myfile.ps
  239. instead of just
  240.     gs myfile.ps
  241. Alternatively, once you are inside Ghostscript, you can type
  242.     (epson) selectdevice
  243.     (myfile.ps) run
  244. All output then goes to the printer instead of the display until further
  245. notice.  You can switch devices at any time by using the selectdevice
  246. procedure, e.g.,
  247.     (vga) selectdevice
  248. or
  249.     (epson) selectdevice
  250. As yet a third alternative, you can define an environment variable
  251. GS_DEVICE as the desired default device name.  The order of precedence for
  252. these alternatives, highest to lowest, is:
  253.     selectdevice
  254.     (command line)
  255.     GS_DEVICE
  256.     (first device in build list)
  257.  
  258. To select the resolution on a printer, use the shell command
  259.     gs -sDEVICE=<device> -r<xres>x<yres>
  260. For example, on a 9-pin Epson-compatible printer, you can get the
  261. lowest-resolution (fastest) mode with
  262.     gs -sDEVICE=epson -r60x72
  263. and the highest-resolution mode with
  264.     gs -sDEVICE=epson -r240x72.
  265. On a 24-pin printer, the lowest resolution is
  266.     gs -sDEVICE=epson -r60x60
  267. and the highest-resolution 24-pin mode is
  268.     gs -sDEVICE=epson -r360x180
  269.  
  270. If you select a printer as the output device, Ghostscript also allows you
  271. to control where the device sends its output.  Normally, output goes
  272. directly to the printer (PRN) on MS-DOS systems, and to a scratch file on
  273. Unix or VMS systems.  To send the output to a series of files foo1.xyz,
  274. foo2.xyz, ..., use the switch
  275.     -sOutputFile=foo%d.xyz
  276. (For compatibility with older versions of Ghostscript, -sOUTPUTFILE=
  277. also works.)  The %d is a printf format specification; you can use
  278. other formats like %02d.  Each file will receive one page of output.
  279. Alternatively, to send the output to a single file foo.xyz, with all
  280. the pages concatenated, use the switch
  281.     -sOutputFile=foo.xyz
  282.  
  283. On Unix systems, you can send the output directly to a pipe.  For
  284. example, to pipe the output to the command `lpr' (which, on many Unix
  285. systems, is the command that spools output for a printer), use the
  286. switch
  287.     -sOutputFile=\|lpr
  288. You can also send output to stdout for piping with the switch
  289.     -sOutputFile=-
  290. In this case you must also use the -q switch, to prevent Ghostscript from
  291. writing messages to stdout.
  292.  
  293. File formats like PCX and PBM are also 'devices'.  When you select a file
  294. format as the 'device', you must also specify an output file, e.g.,
  295.     gs -sDEVICE=pcxmono -sOutputFile=xyz.pcx
  296.  
  297. To find out what devices are available, type
  298.     devicenames ==
  299. after starting up Ghostscript.  Alternatively you can use the -h or
  300. -? switch in the command line, as described above.
  301.  
  302. Choosing paper size
  303. -------------------
  304.  
  305. Ghostscript is normally configured to expect U.S. letter paper.  To select
  306. a different paper size as the default, find the line in gs_init.ps that
  307. says
  308.  
  309.     % Optionally choose a default paper size other than U.S. letter.
  310.  
  311. The next line begins
  312.  
  313.     % (a4)
  314.  
  315. To select A4 as the default paper size, remove the % but do not change
  316. anything else.  To select a different default paper size, remove the % and
  317. replace the word a4 with the name of the desired paper size.  You can use
  318. any paper size listed in the table at the beginning of gs_statd.ps.
  319. (Individual documents can also specify a paper size, which will take
  320. precedence over the one specified on the command line.)
  321.  
  322. Alternatively, to select a different paper size for a single invocation of
  323. Ghostscript, you can use the command line switch
  324.     -sPAPERSIZE=a_known_paper_size
  325. e.g.,
  326.     -sPAPERSIZE=a4
  327. or
  328.     -sPAPERSIZE=legal
  329.  
  330. Finally, most (but not all) of Ghostscript's printer drivers can be
  331. configured at compile time to use A4 paper as the default by including
  332. -DA4 in the CFLAGS switches in the makefile.  See make.doc for more
  333. details.
  334.  
  335. File searching
  336. --------------
  337.  
  338. When looking for the initialization files (gs_*.ps), the files related to
  339. fonts, or the file for the 'run' operator, Ghostscript first checks whether
  340. the file name specifies an explicit directory or drive (i.e., doesn't begin
  341. with '/' on Unix systems; doesn't contain a ':' or begin with a '/' or '\'
  342. on MS-DOS systems; doesn't contain a ':' or a square bracket on VMS
  343. systems).  If it does, Ghostscript simply tries to open the file using the
  344. given name.  Otherwise, Ghostscript will try directories in the following
  345. order:
  346.  
  347.     - The current directory;
  348.  
  349.     - The directory/ies specified by the -I switch(es) in the command
  350.       line (see below), if any;
  351.  
  352.     - The directory/ies specified by the GS_LIB environment variable,
  353.       if any;
  354.  
  355.     - The directory/ies specified by the GS_LIB_DEFAULT macro in the
  356.       Ghostscript makefile, if any.
  357.  
  358. Each of these (GS_LIB_DEFAULT, GS_LIB, and -I parameter) may be either a
  359. single directory, or a list of directories separated by a character
  360. appropriate for the operating system (':' on Unix systems, ';' on VMS
  361. systems, ';' on MS-DOS systems).  We think that trying the current
  362. directory first is a very bad idea -- it opens serious security loopholes
  363. and can lead to very confusing errors if one has more than one version of
  364. Ghostscript in one's environment -- but when we attempted to change it,
  365. users insisted that we change it back.
  366.  
  367. When Ghostscript starts up, it also looks at the GS_FONTPATH environment
  368. variable, which is also a list of directories.  It goes to those
  369. directories and looks for all files that appear to contain PostScript
  370. fonts; it then effectively adds all those files and fonts to its internal
  371. copy of the Fontmap (the catalog of fonts and the files that contain
  372. them).  If you are using one of the following types of computer, you may
  373. wish to set GS_FONTPATH to the indicated value so that Ghostscript will
  374. automatically acquire all the installed Type 1 fonts:
  375.  
  376.     System type        GS_FONTPATH
  377.     -----------        -----------
  378.     AIX            /usr/lpp/DPS/fonts/outlines
  379.     NeXT            /NextLibrary/Fonts/outline
  380.     OSF/1            /usr/lib/X11/fonts/Type1Adobe
  381.     Silicon Graphics    /usr/lib/DPS/outline/base
  382.     Sun (Solaris 2.3)    /usr/openwin/lib/X11/fonts/Type1/outline
  383.     Ultrix            /usr/lib/DPS/outline/decwin
  384.  
  385. These paths may not be exactly right for your installation; if the
  386. indicated directory doesn't contain files whose names are familiar font
  387. names like Courier and Helvetica, you may wish to ask your system
  388. administrator where to find these fonts.
  389.  
  390. Temporary files
  391. ---------------
  392.  
  393. By default, Ghostscript creates temporary files named _temp_XX.XXX in the
  394. current directory on MS-DOS and VMS systems, gsXXXXXX in the current
  395. directory on OS/2 systems, and gs_XXXXX in the /tmp directory on Unix
  396. systems.  You can change the directory in which Ghostscript will create
  397. these files by setting the TEMP environment variable to the name of the
  398. directory.
  399.  
  400. Ghostscript currently doesn't do a very good job of deleting temporary
  401. files when it exits; you may have to delete them manually from time to
  402. time.
  403.  
  404. Environment variable summary
  405. ----------------------------
  406.  
  407. GS_DEVICE
  408.     Defines the default output device.  Described above.
  409.  
  410. GS_FONTPATH
  411.     Specifies a list of directories that should be scanned for fonts
  412. at startup.  Described above.
  413.  
  414. GS_LIB
  415.     Provides a search path for initialization files and fonts.
  416. Described above.
  417.  
  418. GS_OPTIONS
  419.     Defines a list of command line arguments to be processed before
  420. the ones actually specified on the command line.  For example, setting
  421. GS_DEVICE to xxx is equivalent to setting GS_OPTIONS to -sDEVICE=xxx.  The
  422. contents of GS_OPTIONS are not limited to switches; they may include
  423. actual file names or even @file arguments.
  424.  
  425. TEMP
  426.     Defines a directory name for temporary files.  Described above.
  427.  
  428. ********
  429. ******** Notes on specific platforms ********
  430. ********
  431.  
  432. VMS
  433. ---
  434.  
  435. On VMS systems, the last character of each "directory" name indicates what
  436. sort of entity the "directory" references.  If the "directory" name ends
  437. with a colon, it is taken as referring to a logical device, e.g.:
  438.     $ DEFINE GHOSTSCRIPT_DEVICE DUA1:[GHOSTSCRIPT_14]
  439.     $ DEFINE GS_LIB GHOSTSCRIPT_DEVICE:
  440. If the "directory" name ends with a closing square bracket, it is taken as
  441. referring to a real directory, e.g.:
  442.     $ DEFINE GS_LIB DUA1:[GHOSTSCRIPT]
  443.  
  444. To run Ghostscript with switches, you must type a command like
  445.  
  446.     $ gs "-dNODISPLAY"
  447.  
  448. because the C run time library will convert the command
  449. parameters/arguments to lowercase unless you enclose them in double quotes
  450. which preserves the case.
  451.  
  452. If you are on an X Windows display (for which gs is built), you can do
  453.  
  454.     $ set display/create/node="domain-name"/transport=tcpip
  455.  
  456. For example,
  457.  
  458.     $ set display/create/node="doof.city.com"/transport=tcpip
  459.  
  460. and then run Ghostscript
  461.  
  462.     $ gs
  463.  
  464. If you write printer output to a file and then want to print the file
  465. later, use the "/PASSALL" qualifier to the PRINT command.
  466.  
  467. In order to get PDF files (or PostScript files that use the setfileposition
  468. operator) to work properly on VMS systems, you must ensure that they are
  469. "stream LF" type files.  If you transfer files by FTP, you probably need to
  470. do one of the following two things after the transfer:
  471.  
  472. 1. If FTP'd in text/ASCII mode then do:
  473.  
  474.      $ CONVERT/FDL=STREAMLF.FDL input-file output-file
  475.  
  476.    where the contents of the file STREAMLF.FDL are given below.
  477.  
  478. 2. Otherwise, if FTP'd in binary mode do
  479.  
  480.      $ SET FILE/ATTRIBUTE=(RFM:STMLF)
  481.  
  482. The contents of the STREAMLF.FDL file are shown between, and exclusive of, the
  483. dashed lines:
  484.  
  485. -------------------------------------------------
  486. FILE
  487.         ORGANIZATION            sequential
  488.  
  489. RECORD
  490.         BLOCK_SPAN              yes
  491.         CARRIAGE_CONTROL        carriage_return
  492.         FORMAT                  stream_lf
  493. -------------------------------------------------
  494.  
  495. MS-DOS
  496. ------
  497.  
  498. Ghostscript supports many SuperVGA displays directly, most of them with
  499. more than 16 colors.  The complete list is in the file devs.mak, which is
  500. part of the Ghostscript source code.  (If you got Ghostscript under the
  501. Aladdin Ghostscript Free Public License, the person or place from which you
  502. got it is also required to make the source code available to you; if you
  503. got it under the GNU License, see the GNU License for more information.)
  504.  
  505. If you have a SuperVGA display that supports a 16-color mode with 800x600
  506. pixels, and you know the display mode number for this mode, you can select
  507. it by using the command line switches
  508.     -sDEVICE=svga16 -dDisplayMode=NNN
  509. where NNN is the display mode number in decimal.  The modes for some
  510. popular display chipsets are as follows:
  511.  
  512.     Acumos AVGA2, AVGA3                         88    (0x58)
  513.     Advance Logic AL2101                        43    (0x2B)
  514.     Ahead V5000                                 113    (0x71)
  515.     ATI VGAWONDER, Graphics Ultra etc.          84    (0x54)
  516.     Chips and Technologies                      106    (0x6A)
  517.     Cirrus Logic CL-GD 500/600                  100    (0x64)
  518.     Cirrus Logic GD 5422                        88    (0x58)
  519.     Compaq VGA                                  89    (0x59)
  520.     CTI                                         106    (0x6A)
  521.   * Genoa 5xxx, Sigma VGA                       41    (0x29)
  522.     Genoa 6xxx                                  106    (0x6A)
  523.     MXIC MX 68010                               85    (0x55)
  524.     NCR 77C22                                   88    (0x58)
  525.     OAK Technologies OTI-067, OTI-077, OTI037C  82    (0x52)
  526.     OAK Technologies OTI037C w/ NEL BIOS        91    (0x5B)
  527.   * Orchid Prodesigner                          41    (0x29)
  528.     Paradise                                    88    (0x58)
  529.     Poach                                       106    (0x6A)
  530.     Primus                                      42    (0x2A)
  531.     Realtek RT 3106                             31    (0x1F)
  532.     Tecmar                                      22    (0x16)
  533.     Trident 8900                                91    (0x5B)
  534.   * Tseng ET-3000, ET-4000                      41    (0x29)
  535.   * VEGA                                        41    (0x29)
  536.     Video 7 SVGA                                98    (0x62)
  537.     WD90C11                                     92    (0x5C)
  538.     Western Digital                             88    (0x58)
  539.  
  540. The ones marked * are the default (they all use the same value.)  If your
  541. card's chipset doesn't appear on this list, or if you try the value here
  542. and it doesn't work, please e-mail the chipset and correct display mode to
  543. ghost@aladdin.com for inclusion in future releases.
  544.  
  545. If you are running Ghostscript on a MS-DOS machine with a display that is
  546. not EGA/VGA compatible, you must use the Borland compiler.  You must build
  547. Ghostscript with the BGI driver as the default, and you will need the
  548. appropriate .BGI file from the Borland Turbo C library.  (Ghostscript
  549. includes the EGA/VGA driver in the executable.)
  550.  
  551. If you are using the BGI driver, two additional environment variables
  552. become relevant:
  553.  
  554.     BGIPATH - defines the directory where Ghostscript will look for
  555. the appropriate BGI driver.  If BGIPATH is not defined, Ghostscript will
  556. look in the directory defined as BGIDIR in the makefile.  In either case,
  557. if no driver is found in the designated directory, Ghostscript will look
  558. in the current directory.
  559.  
  560.     BGIUSER - a string of the form nn.dname, where nn is a hexadecimal
  561. number giving a display mode and dname is the name of a file containing a
  562. user-supplied BGI driver.  If BGIUSER is defined and the BGI device is
  563. selected, Ghostscript will supply nn as the display mode and will obtain
  564. the driver from the file named dname.
  565.  
  566. Some applications, such as Microsoft Word, require a prologue in front of
  567. the PostScript files they output.  In the case of Word, this is one of the
  568. *.ini files included with the Word distribution.  Other applications may
  569. require other prologues.  These may be specified on the Ghostscript
  570. command line, e.g.,
  571.     gs prologue.ini myfile.ps
  572.  
  573. X Windows
  574. ---------
  575.  
  576. Ghostscript looks for the following resources under the program name
  577. "ghostscript" and class name "Ghostscript":
  578.  
  579.     Name            Class            Default
  580.     ----            -----            -------
  581.     background        Background        white
  582.     foreground        Foreground        black
  583.     borderColor        BorderColor        black
  584.     borderWidth        BorderWidth        1
  585.     geometry        Geometry        NULL
  586.     xResolution        Resolution        **
  587.     yResolution        Resolution        **
  588.     useExternalFonts    UseExternalFonts    true
  589.     useScalableFonts    UseScalableFonts    true
  590.     logExternalFonts    LogExternalFonts    false
  591.     externalFontTolerance    ExternalFontTolerance    10.0
  592.     palette            Palette            Color
  593.     maxGrayRamp        MaxGrayRamp        128
  594.     maxRGBRamp        MaxRGBRamp        5
  595.         maxDynamicColors    MaxDynamicColors    256
  596.     useBackingPixmap    UseBackingPixmap    true
  597.     useXPutImage        UseXPutImage        true
  598.     useXSetTile        UseXSetTile        true
  599.     regularFonts        RegularFonts        see below
  600.     symbolFonts        SymbolFonts        see below
  601.     dingbatFonts        DingbatFonts        see below
  602.  
  603. ** Calculated from display metrics.
  604.  
  605.     Notes on Resources:
  606.  
  607.     Ghostscript doesn't look at the default system background and
  608.     foreground colors; if you want to change the background or
  609.     foreground color, you must set them explicitly for Ghostscript.
  610.     (This is a deliberate choice, so that PostScript documents will
  611.     display correctly -- with white = white and black = black --
  612.     by default, even if text windows use other colors.)
  613.  
  614.     The geometry resource only affects window placement.
  615.  
  616.     Resolution is given in pixels per inch.
  617.  
  618.     The font tolerance gives largest acceptable difference in
  619.     height of the screen font.  The tolerance is expressed as
  620.     a percentage of the height of the desired font.
  621.  
  622.     The palette resource can be used to restrict ghostscript to
  623.     using a grayscale or monochrome palette.
  624.  
  625.     The maxRGBRamp and maxGrayRamp control the maximum number of
  626.     colors that ghostscript allocates ahead of time for the dither
  627.     cube/ramp.  Ghostscript will never preallocate more than half
  628.     of the cells in a colormap.  maxDynamicColors controls the
  629.     maximum number of colors that Ghostscript will allocate
  630.     dynamically in the colormap.
  631.  
  632. The use... resources exist primarily to work around bugs in X servers.  In
  633. particular, many versions of DEC's X server (DECwindows) have bugs that
  634. require setting useXPutImage or useXSetTile to false.
  635.  
  636.     Some servers do not implement backing pixmaps properly, or do not
  637.     have enough memory for them.  If you get strange behavior or "out
  638.     of memory" messages, try setting useBackingPixmap to false.
  639.  
  640.     Some servers do not implement tiling properly.  This will show up
  641.     as broad bands of color where dither patterns should appear.  If
  642.     this happens, try setting useXSetTile to false.
  643.  
  644.     Some servers do not implement bitmap/pixmap displaying properly.
  645.     This may show up as white or black rectangles where characters
  646.     should appear, or characters may appear in "inverse video" (e.g.,
  647.     white on a black rectangle).  If this happens, try setting
  648.     useXPutImage to false.
  649.  
  650. To use native X11 fonts, Ghostscript must map PostScript font names to
  651. the XLFD font names.  The regularFonts, symbolFonts, and dingbatFonts
  652. resources give the name mapping for different encodings.  The XLFD font 
  653. name in the mapping must contain seven dashes.  The X driver adds the
  654. additional size and encoding fields to bring the total number of dashes
  655. in the font name to 14.  Here are the default font mappings:
  656.  
  657.   Regular Fonts: (Fonts available in standard or ISO-Latin-1 encoding)
  658.  
  659.     AvantGarde-Book:-Adobe-ITC Avant Garde Gothic-Book-R-Normal--\n\
  660.     AvantGarde-BookOblique:-Adobe-ITC Avant Garde Gothic-Book-O-Normal--\n\
  661.     AvantGarde-Demi:-Adobe-ITC Avant Garde Gothic-Demi-R-Normal--\n\
  662.     AvantGarde-DemiOblique:-Adobe-ITC Avant Garde Gothic-Demi-O-Normal--\n\
  663.     Bookman-Demi:-Adobe-ITC Bookman-Demi-R-Normal--\n\
  664.     Bookman-DemiItalic:-Adobe-ITC Bookman-Demi-I-Normal--\n\
  665.     Bookman-Light:-Adobe-ITC Bookman-Light-R-Normal--\n\
  666.     Bookman-LightItalic:-Adobe-ITC Bookman-Light-I-Normal--\n\
  667.     Courier:-Adobe-Courier-Medium-R-Normal--\n\
  668.     Courier-Bold:-Adobe-Courier-Bold-R-Normal--\n\
  669.     Courier-BoldOblique:-Adobe-Courier-Bold-O-Normal--\n\
  670.     Courier-Oblique:-Adobe-Courier-Medium-O-Normal--\n\
  671.     Helvetica:-Adobe-Helvetica-Medium-R-Normal--\n\
  672.     Helvetica-Bold:-Adobe-Helvetica-Bold-R-Normal--\n\
  673.     Helvetica-BoldOblique:-Adobe-Helvetica-Bold-O-Normal--\n\
  674.     Helvetica-Narrow:-Adobe-Helvetica-Medium-R-Narrow--\n\
  675.     Helvetica-Narrow-Bold:-Adobe-Helvetica-Bold-R-Narrow--\n\
  676.     Helvetica-Narrow-BoldOblique:-Adobe-Helvetica-Bold-O-Narrow--\n\
  677.     Helvetica-Narrow-Oblique:-Adobe-Helvetica-Medium-O-Narrow--\n\
  678.     Helvetica-Oblique:-Adobe-Helvetica-Medium-O-Normal--\n\
  679.     NewCenturySchlbk-Bold:-Adobe-New Century Schoolbook-Bold-R-Normal--\n\
  680.     NewCenturySchlbk-BoldItalic:-Adobe-New Century Schoolbook-Bold-I-Normal--\n\
  681.     NewCenturySchlbk-Italic:-Adobe-New Century Schoolbook-Medium-I-Normal--\n\
  682.     NewCenturySchlbk-Roman:-Adobe-New Century Schoolbook-Medium-R-Normal--\n\
  683.     Palatino-Bold:-Adobe-Palatino-Bold-R-Normal--\n\
  684.     Palatino-BoldItalic:-Adobe-Palatino-Bold-I-Normal--\n\
  685.     Palatino-Italic:-Adobe-Palatino-Medium-I-Normal--\n\
  686.     Palatino-Roman:-Adobe-Palatino-Medium-R-Normal--\n\
  687.     Times-Bold:-Adobe-Times-Bold-R-Normal--\n\
  688.     Times-BoldItalic:-Adobe-Times-Bold-I-Normal--\n\
  689.     Times-Italic:-Adobe-Times-Medium-I-Normal--\n\
  690.     Times-Roman:-Adobe-Times-Medium-R-Normal--\n\
  691.     ZapfChancery-MediumItalic:-Adobe-ITC Zapf Chancery-Medium-I-Normal--
  692.  
  693.   Symbol Fonts:  (using Symbol encoding)
  694.  
  695.     Symbol: -Adobe-Symbol-Medium-R-Normal--
  696.  
  697.   Dingbat Fonts: (using Dingbat encoding)
  698.  
  699.     ZapfDingbats: -Adobe-ITC Zapf Dingbats-Medium-R-Normal--
  700.  
  701. For X11/NeWS, one can use the OpenWindows scalable fonts instead, which
  702. will give good quality output for any point size.  In this environment,
  703. the relevant section of the resource file should look like this:
  704.  
  705. Ghostscript.regularFonts: \
  706.     AvantGarde-Book:        -itc-avantgarde-book-r-normal-- \n\
  707.     AvantGarde-BookOblique:        -itc-avantgarde-book-o-normal-- \n\
  708.     AvantGarde-Demi:        -itc-avantgarde-demi-r-normal-- \n\
  709.     AvantGarde-DemiOblique:        -itc-avantgarde-demi-o-normal-- \n\
  710.     Bembo:                -monotype-bembo-medium-r-normal-- \n\
  711.     Bembo-Bold:            -monotype-bembo-bold-r-normal-- \n\
  712.     Bembo-BoldItalic:        -monotype-bembo-bold-i-normal-- \n\
  713.     Bembo-Italic:            -monotype-bembo-medium-i-normal-- \n\
  714.     Bookman-Demi:            -itc-bookman-demi-r-normal-- \n\
  715.     Bookman-DemiItalic:        -itc-bookman-demi-i-normal-- \n\
  716.     Bookman-Light:            -itc-bookman-light-r-normal-- \n\
  717.     Bookman-LightItalic:        -itc-bookman-light-i-normal-- \n\
  718.     Courier:            -itc-courier-medium-r-normal-- \n\
  719.     Courier-Bold:            -itc-courier-bold-r-normal-- \n\
  720.     Courier-BoldOblique:        -itc-courier-bold-o-normal-- \n\
  721.     Courier-Oblique:        -itc-courier-medium-o-normal-- \n\
  722.     GillSans:            -monotype-gill-medium-r-normal-sans- \n\
  723.     GillSans-Bold:            -monotype-gill-bold-r-normal-sans- \n\
  724.     GillSans-BoldItalic:        -monotype-gill-bold-i-normal-sans- \n\
  725.     GillSans-Italic:        -monotype-gill-normal-i-normal-sans- \n\
  726.     Helvetica:            -linotype-helvetica-medium-r-normal-- \n\
  727.     Helvetica-Bold:            -linotype-helvetica-bold-r-normal-- \n\
  728.     Helvetica-BoldOblique:        -linotype-helvetica-bold-o-normal-- \n\
  729.     Helvetica-Narrow:        -linotype-helvetica-medium-r-narrow-- \n\
  730.     Helvetica-Narrow-Bold:        -linotype-helvetica-bold-r-narrow-- \n\
  731.     Helvetica-Narrow-BoldOblique:    -linotype-helvetica-bold-o-narrow-- \n\
  732.     Helvetica-Narrow-Oblique:    -linotype-helvetica-medium-o-narrow-- \n\
  733.     Helvetica-Oblique:        -linotype-helvetica-medium-o-normal-- \n\
  734.     LucidaBright:            -b&h-lucidabright-medium-r-normal-- \n\
  735.     LucidaBright-Demi:        -b&h-lucidabright-demibold-r-normal-- \n\
  736.     LucidaBright-DemiItalic:    -b&h-lucidabright-demibold-i-normal-- \n\
  737.     LucidaBright-Italic:        -b&h-lucidabright-medium-i-normal-- \n\
  738.     LucidaSans:            -b&h-lucida-medium-r-normal-sans- \n\
  739.     LucidaSans-Bold:        -b&h-lucida-bold-r-normal-sans- \n\
  740.     LucidaSans-BoldItalic:        -b&h-lucida-bold-i-normal-sans- \n\
  741.     LucidaSans-Italic:        -b&h-lucida-medium-i-normal-sans- \n\
  742.     LucidaSans-Typewriter:        -b&h-lucidatypewriter-medium-r-normal-sans- \n\
  743.     LucidaSans-TypewriterBold:    -b&h-lucidatypewriter-bold-r-normal-sans- \n\
  744.     NewCenturySchlbk-BoldItalic:    -linotype-new century schoolbook-bold-i-normal-- \n\
  745.     NewCenturySchlbk-Bold:        -linotype-new century schoolbook-bold-r-normal-- \n\
  746.     NewCenturySchlbk-Italic:    -linotype-new century schoolbook-medium-i-normal-- \n\
  747.     NewCenturySchlbk-Roman:        -linotype-new century schoolbook-medium-r-normal-- \n\
  748.     Palatino-Bold:            -linotype-palatino-bold-r-normal-- \n\
  749.     Palatino-BoldItalic:        -linotype-palatino-bold-i-normal-- \n\
  750.     Palatino-Italic:        -linotype-palatino-medium-i-normal-- \n\
  751.     Palatino-Roman:            -linotype-palatino-medium-r-normal-- \n\
  752.     Rockwell:            -monotype-rockwell-medium-r-normal-- \n\
  753.     Rockwell-Bold:            -monotype-rockwell-bold-r-normal-- \n\
  754.     Rockwell-BoldItalic:        -monotype-rockwell-bold-i-normal-- \n\
  755.     Rockwell-Italic:        -monotype-rockwell-medium-i-normal-- \n\
  756.     Times-Bold:            -linotype-times-bold-r-normal-- \n\
  757.     Times-BoldItalic:        -linotype-times-bold-i-normal-- \n\
  758.     Times-Italic:            -linotype-times-medium-i-normal-- \n\
  759.     Times-Roman:            -linotype-times-medium-r-normal-- \n\
  760.     Utopia-Bold:            -adobe-utopia-bold-r-normal-- \n\
  761.     Utopia-BoldItalic:        -adobe-utopia-bold-i-normal-- \n\
  762.     Utopia-Italic:            -adobe-utopia-regular-i-normal-- \n\
  763.     Utopia-Regular:            -adobe-utopia-regular-r-normal-- \n\
  764.     ZapfChancery-MediumItalic:    -itc-zapfchancery-medium-i-normal-- \n
  765. Ghostscript.dingbatFonts: \
  766.     ZapfDingbats:            -itc-zapfdingbats-medium-r-normal--
  767. Ghostscript.symbolFonts: \
  768.     Symbol:                --symbol-medium-r-normal--
  769.  
  770. Users who switch regularly between different X servers may wish to use the
  771. '*' wild card in place of the foundry name (itc, monotype, linotype, b&h,
  772. or adobe); users who do not switch X servers should leave the explicit
  773. foundry in the name, since it speeds up font accessing.
  774.  
  775. To set these resources, put them in a file (such as ~/.Xdefaults) in the
  776. following form:
  777.  
  778. Ghostscript*geometry:    -0+0
  779. Ghostscript*xResolution: 72
  780. Ghostscript*yResolution: 72
  781.  
  782. Then load the defaults into the X server:
  783.  
  784. % xrdb -merge ~/.Xdefaults
  785.  
  786. Ghostscript will take advantage of the "HP XLFD Enhancements," if
  787. available, to use native X11 fonts for fonts that are anamorphically
  788. scaled, rotated, or mirrored.  If the user has installed these changes to
  789. their X or font server, they will automatically be used when appropriate.
  790.  
  791. SCO Unix
  792. --------
  793.  
  794. Because of bugs in the SCO Unix kernel, Ghostscript will not work if you
  795. select direct screen output (gdevsco.c) and also allow it to write messages
  796. on the console.  If you are using direct screen output, redirect
  797. Ghostscript's terminal output to a file.
  798.  
  799. ********
  800. ******** Switches
  801. ********
  802.  
  803. Unless otherwise noted, these apply to all platforms.
  804.  
  805. Normal switches
  806. ---------------
  807.  
  808.     @filename
  809.         Causes Ghostscript to read filename and treat its
  810.         contents the same as the command line.  (This is
  811.         intended primarily for getting around MS-DOS's
  812.         128-character limit on the length of a command line.)
  813.         Switches or file names in the file may be separated by
  814.         any amount of white space (space, tab, line break);
  815.         there is no limit on the size of the file.
  816.  
  817.     -- filename arg1 ...
  818.     -+ filename arg1 ...
  819.         Takes the next argument as a file name as usual, but takes
  820.         all remaining arguments (even if they have the syntactic
  821.         form of switches) and defines the name ARGUMENTS in
  822.         userdict (not systemdict) as an array of those strings,
  823.         *before* running the file.  When Ghostscript finishes
  824.         executing the file, it exits back to the shell.
  825.  
  826.     -@ filename arg1 ...
  827.         Does the same thing as -- and -+, but expands @filename
  828.         arguments.
  829.  
  830.     -c tokens ...
  831.         Interprets arguments, up to the next argument that begins
  832.         with - followed by a non-digit or with @, as PostScript
  833.         code.  For example, if the file quit.ps contains just
  834.         the word `quit', the following are equivalent:
  835.             quit.ps
  836.         and
  837.             -c quit
  838.         Each argument must be exactly one token, as defined by
  839.         the `token' operator.
  840.  
  841.     -Dname=token
  842.     -dname=token
  843.         Define a name in systemdict with the given definition.
  844.         The token must be exactly one token (as defined by the
  845.         'token' operator) and must not contain any whitespace.
  846.  
  847.     -Dname
  848.     -dname
  849.         Define a name in systemdict with value=true.
  850.  
  851.     -Sname=string
  852.     -sname=string
  853.         Define a name in systemdict with a given string as value.
  854.         This is different from -d.  For example,
  855.             -dname=35
  856.         is equivalent to the program fragment
  857.             /name 35 def
  858.         whereas
  859.             -sname=35
  860.         is equivalent to
  861.             /name (35) def
  862.  
  863.     -q
  864.         Quiet startup -- suppress normal startup messages,
  865.         and also do the equivalent of -dQUIET.
  866.  
  867.     -ffilename
  868.         Execute the given file, even if its name begins with a -
  869.         or an @.  -f alone does nothing, but it provides a
  870.         convenient way to terminate the list of tokens for the -c
  871.         switch.
  872.  
  873.     -gnumber1xnumber2
  874.         Equivalent to -dDEVICEWIDTH=number1 and
  875.         -dDEVICEHEIGHT=number2.  This is for the benefit of
  876.         devices (such as X11 windows and VESA displays) that require
  877.         (or allow) width and height to be specified.
  878.  
  879.     -rnumber
  880.     -rnumber1xnumber2
  881.         Equivalent to -dDEVICEXRESOLUTION=number1 and
  882.         -dDEVICEYRESOLUTION=number2.  This is for the benefit of
  883.         devices (such as printers) that support multiple
  884.         X and Y resolutions.
  885.  
  886.     -Idirectories
  887.         Adds the designated list of directories at the head of the
  888.         search path for library files.
  889.  
  890.     -
  891.         This is not really a switch.  It indicates to Ghostscript
  892.         that the standard input is coming from a file or a pipe.
  893.         Ghostscript reads from stdin until reaching end-of-file,
  894.         executing it like any other file, and then continues
  895.         processing the command line.  At the end of the command
  896.         line, Ghostscript exits rather than going into its
  897.         interactive mode.
  898.  
  899. Note that gs_init.ps makes systemdict read-only, so the values of names
  900. defined with -D/d/S/s cannot be changed (although, of course, they can be
  901. superseded by definitions in userdict or other dictionaries.)
  902.  
  903. Special names
  904. -------------
  905.  
  906. -dDISKFONTS
  907.     causes individual character outlines to be loaded from the disk
  908. the first time they are encountered.  (Normally Ghostscript loads all the
  909. character outlines when it loads a font.)  This may allow loading more
  910. fonts into RAM, at the expense of slower rendering.
  911.  
  912. -dNOBIND
  913.     disables the 'bind' operator.  Only useful for debugging.
  914.  
  915. -dNOCACHE
  916.     disables character caching.  Only useful for debugging.
  917.  
  918. -dNOCIE
  919.     substitutes DeviceGray and DeviceRGB for CIEBasedA and CIEBasedABC
  920. color spaces respectively.  Only useful on very slow systems where color
  921. accuracy is less important.
  922.  
  923. -dNODISPLAY
  924.     suppresses the normal initialization of the output device.  This
  925. may be useful when debugging.
  926.  
  927. -dNOGC
  928.     disables the garbage collector in Level 2 systems.  Only
  929. useful for debugging.
  930.  
  931. -dNOPAUSE
  932.     disables the prompt and pause at the end of each page.  This may
  933. be desirable for applications where another program is 'driving'
  934. Ghostscript.
  935.  
  936. -dNOPLATFONTS
  937.     disables the use of fonts supplied by the underlying platform
  938. (X Windows or Microsoft Windows).  This may be needed if the platform
  939. fonts look undesirably different from the scalable fonts.
  940.  
  941. -dORIENT1
  942.     indicates that the file uses a value of 1 to indicate portrait
  943. orientation to setpage[params] rather than the default orientation of 0.
  944. This is needed for some files produced by badly designed applications that
  945. 'know' that the output will be printed on certain roll-media printers.
  946.  
  947. -dSAFER
  948.     disables the deletefile and renamefile operators, and the
  949. ability to open files in any mode other than read-only.  This may be
  950. desirable for spoolers or other sensitive environments.
  951.  
  952. -dWRITESYSTEMDICT
  953.     leaves systemdict writable.  This is necessary when running
  954. special utility programs such as font2c and pcharstr, which must bypass
  955. normal PostScript access protection.
  956.  
  957. -sDEVICE=device
  958.     selects an alternate initial output device, as described above.
  959.  
  960. -sOutputFile=filename
  961.     selects an alternate output file (or pipe) for the initial output
  962. device, as described above.
  963.  
  964. Debugging switches
  965. ------------------
  966.  
  967. The -Z switch only applies if the interpreter was built for a
  968. debugging configuration (DEBUG=1 or -DDEBUG selected at compile
  969. time).
  970.  
  971.     -A    Fill empty storage with a distinctive bit pattern
  972.         for debugging.  Equivalent to -Z@.
  973.  
  974.     -E    Turn on tracing of error returns from operators.
  975.         Equivalent to -Z#.
  976.  
  977.     -Mn    Force the interpreter's allocator to acquire additional
  978.         memory in units of nK, rather than the default (currently
  979.         20K on MS-DOS systems, 50K on Unix).  n is a positive
  980.         decimal integer (not exceeding 63 on MS-DOS systems).
  981.  
  982.     -Zxxx    Turn on debugging printout.
  983.         Each of the xxx characters selects an option.
  984.         Case is significant.
  985.             0 = OS-related calls
  986.             1 = type 1 font interpreter (type1addpath)
  987.             2 = curve subdivider/rasterizer
  988.               3 = curve subdivider/rasterizer, detail
  989.             4 = garbage collector (strings)
  990.               5 = garbage collector (strings, detail)
  991.             6 = garbage collector (chunks, roots)
  992.               7 = garbage collector (objects)
  993.               8 = garbage collector (refs)
  994.               9 = garbage collector (pointers)
  995.             a = allocator (large blocks only)
  996.               A = allocator (all calls)
  997.             b = bitmap image processor
  998.               B = bitmap images, detail
  999.             c = color/halftone mapper
  1000.             d = dictionary put/undef
  1001.               D = dictionary lookups
  1002.             f = fill algorithm (summary)
  1003.               F = fill algorithm (detail)
  1004.             g = gsave/grestore[all]
  1005.             h = halftone renderer
  1006.               H = halftones, every pixel
  1007.             i = interpreter, just names
  1008.               I = interpreter, everything
  1009.             j = (Japanese) composite fonts
  1010.             k = character cache & xfonts
  1011.               K = character cache, every access
  1012.             l = command lists, bands
  1013.               L = command lists, everything
  1014.             m = makefont and font cache
  1015.             n = name lookup (new names only)
  1016.             o = outliner (stroke)
  1017.               O = stroke detail
  1018.             p = path tracer
  1019.             q = clipping
  1020.             r = arc renderer
  1021.             s = streams
  1022.               S = scanner
  1023.             t = tiling algorithm
  1024.             u = undo saver (for save/restore), finalization
  1025.               U = undo saver, more detail
  1026.             v = rectangle fill
  1027.               V = device-level output
  1028.             w = compression encoder/decoder
  1029.             x = transformations
  1030.             y = Type 1 hints
  1031.               Y = Type 1 hints, every access
  1032.             z = trapezoid fill
  1033.             # = operator error returns
  1034.             ~ = math functions
  1035.         The following switches select debugging options other than
  1036.         printout.
  1037.             $ = set unused parts of object references to
  1038.                 identifiable garbage values
  1039.             + = use minimum-size stack blocks
  1040.             . = use small-memory table sizes even on
  1041.                 large-memory machines
  1042.             ? = validate pointers before, during and after GC,
  1043.                 also before and after save and restore
  1044.             @ = clear storage when allocating or freeing
  1045.  
  1046. ********
  1047. ******** Frequently Asked Questions
  1048. ********
  1049.  
  1050. Q: The spacing of characters / words / margins on the display is
  1051. wrong, what can I do?
  1052.  
  1053. A: This is almost always caused by differences between the character
  1054. widths that were used to format the document and the character widths
  1055. of the fonts installed in your system.  (This only affects the
  1056. display, and only with window systems, not with MS-DOS.)  If this
  1057. happens, invoke Ghostscript with the -dNOPLATFONTS switch, or (on X
  1058. Windows) set
  1059.     Ghostscript*useExternalFonts: false
  1060. in your X resource file.
  1061.  
  1062. For more information about fonts on the display, please read the
  1063. first sections of fonts.doc.
  1064.  
  1065. Q: On my H-P LaserJet, why do I only get a partial page of output, or a
  1066. single page gets split across two sheets?
  1067.  
  1068. A: Printing on a Hewlett-Packard LaserJet at full resolution (300 DPI)
  1069. requires a printer with at least 1.5 Mb of memory.  150 DPI printing
  1070. requires only .5 Mb.  You can select 150 DPI printing with the command
  1071. line switch
  1072.     -r150
  1073. (This is not necessary on DeskJet printers.)
  1074.  
  1075. Q: On my MS-DOS system using GS.EXE (Borland compiler), why do I get a
  1076. `limitcheck in setdevice' or `VMerror in setdevice' error message?
  1077.  
  1078. A: On MS-DOS systems using the Borland compiler, if Ghostscript gives you
  1079. a 'limitcheck in setdevice' error, it may mean Ghostscript's standard
  1080. buffer size wasn't large enough.  Likewise, if Ghostscript gives you a
  1081. 'VMerror in setdevice' error, it means the buffer size was too large.  You
  1082. can use the -dBufferSpace= switch to set the buffer size to a different
  1083. value, e.g.,
  1084.     -dBufferSpace=50000
  1085. The default value is 25000; the smallest value Ghostscript accepts is
  1086. 10000; the largest valid value is 65000.
  1087.